home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / program / allswag.zip / READER.DOC < prev    next >
Text File  |  1993-11-21  |  12KB  |  256 lines
  1.  
  2.  
  3.                               READER.EXE v2.5
  4.                            (SWAG packet READER)
  5.                                 (c) GDSOFT
  6.                                November 1993
  7.  
  8. INTRODUCTION
  9. ------------
  10.  
  11. SWAG (SourceWare Archival Group) is a collection of source code and program
  12. examples for the PASCAL programming language. The material has been donated
  13. by  various  PASCAL  programmers  from  around  the  world,  who  desire to
  14. contribute to the advancement of  one of the greatest programming languages
  15. there is.  MANY THANKS to all  who have contributed. As  such, NO CHARGE OF
  16. ANY KIND IS PERMITTED FOR THIS WORK.
  17.  
  18. The material has been collected from various network conferences worldwide,
  19. and organized  according to subject.  New material is  added quarterly, and
  20. new SWAG  packets are available  from various BBS  sources on a  FIRST call
  21. basis. See BBS.TXT for current support sites and how your BBS can join.
  22.  
  23. GETTING STARTED
  24. ----------------
  25.  
  26. The program READER.EXE is a executable program that will allow you to read,
  27. extract or print the contents of  SWAG packets. These packets are organized
  28. according to subject, with each one containing a number of PASCAL "snipets"
  29. on that subject. In the rest of this document, I'll refer to the program as
  30. "READER".
  31.  
  32. The SWAG packets should be placed ALL together in a directory on your disk.
  33. It is recommended that you create a single directory named '\SWAG'. You can
  34. use the DOS command :
  35.  
  36.                             mkdir c:\swag
  37.  
  38. Unpack  the distribution  archives and  place  all  of the  files with  the
  39. extension of "*.SWG" in this directory along with READER.EXE.
  40.  
  41. USING THE READER
  42. ----------------
  43.  
  44. Using the  reader is really very  simple. Just execute it,  and you will be
  45. presented with a  directory of all of the .SWG  files in the directory that
  46. READER is  located in. If you  have .SWG files elsewhere  on your disk, you
  47. can move around the disk to find them by selecting the ".." file which will
  48. take you to the  PARENT directory. Use the HOME, END and  the arrow keys to
  49. maneuver around.
  50.  
  51. ALSO,
  52.  
  53. The directory window  is search key sensitive. This means  that if you have
  54. .SWG files  or directories listed in  the directory box, you  can just type
  55. the name of the file you want.  For example, pressing 'A' will place you at
  56. the first  entry starting with  'A'. Press 'N',  and you will  jump the the
  57. entry with 'AN...'  if you have one. If  NOT, you will jump the  first file
  58. starting with the letter 'N'.
  59.  
  60. At the bottom  of the screen you will notice  a menu indicating some cursor
  61. and function keys :
  62.  
  63.                         F2 - GREP
  64.                         F5 - Toggle STATS
  65.  
  66.                         <ENTER> - GO
  67.                         ESC - QUIT
  68.  
  69. F2 calls  the GREP (search)  function. This is  a VERY POWERFUL  and useful
  70. function, but  in order to  use this function,  you MUST have  at least ONE
  71. .SWG file  in the directory  box, and it  MUST be highlighted  !! Place the
  72. cursor any one of the .SWG files,  and press F2. You will be presented with
  73. a prompt window :
  74.  
  75.  
  76.                            SWAG Message Base Viewer
  77. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  78. ▓╒ D:\SWAG\FILES\╕▓▓▓▓┌──────────── SOURCEWARE ARCHIVAL GROUP ───────────┐▓
  79. ▓│ ..\           │▓▓▓▓│                                                  │▓
  80. ▓│ ANSI.SWG      │▓▓▓▓│ Your SWAG Support Team :                         │▓
  81. ▓│ ARCHIVES.SWG  │▓▓▓▓│                                                  │▓
  82. ▓│ CHARS.SWG     │▓▓▓▓│ Gayle Davis  Goshen, Indiana  46526              │▓
  83. ▓│ CMDLINE.SWG   │▓▓▓▓│ Kerry Sokalsky  North York, Ontario  M2P 1L2     │▓
  84. ▓│ COLOR.SWG     │▓▓▓▓│                                                  │▓
  85. ▓│ COMM.SWG      │▓▓▓▓│ About SWAG :                                     │▓
  86. ▓│ COPYMOVE.SWG  │▓▓▓▓│                                                  │▓
  87. ▓│ CRC.SWG       │▓▓▓▓│ SWAG is a collection of source code and program  │▓
  88. ▓│ CRT.SWG       │▓▓▓▓│ examples for the PASCAL program language.   The  │▓
  89. ▓│ CUR┌─────────────────────── GREP SWAG Files ───────────────────────┐L │▓
  90. ▓│ DAT│  Search For : CURSOR;ANSI;CRT                                 │n │▓
  91. ▓│ DAT└───────────────────────────────────────────────────────────────┘t │▓
  92. ▓│ DESQVIEW.SWG  │▓▓▓▓│ programming platforms available today.           │▓
  93. ▓│ DIRS.SWG      │▓▓▓▓│                                                  │▓
  94. ▓│ DOS.SWG       │▓▓▓▓│ MUCH THANKS AND GRATITUDE TO ALL CONTRIBUTORS !! │▓
  95. ▓╘═   for more ═╛▓▓▓▓│ NO Charge of ANY kind is permitted for this work │▓
  96. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│                                                  │▓
  97. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓└──────────────────────────────────────────────────┘▓
  98. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  99.  
  100. Enter a string  to search for. You may enter  MULTIPLE items separated by a
  101. semicolon  (;). Additionally,  you can  also include  a date  in the format
  102. MM/DD/YY, and ONLY  records AFTER this date will be  included. If you enter
  103. JUST  the date,  ALL SWAG  snipets AFTER  this date  will be  included. For
  104. example,  entering CURSOR;ANSI;CRT;05/08/93  would search  the SWAG packets
  105. for  matches for  CURSOR, ANSI  and CRT  occurring AFTER 05/08/93. Entering
  106. JUST 05/08/93  at the prompt  would bring back  ALL snipets AFTER  05/08/93
  107. REGARDLESS of the subject.
  108.  
  109. READER will  search ALL of  the SWAG packets  in the CURRENT  directory for
  110. matches  based on  your criteria.  A processing  box will  appear, and  all
  111. occurrences of your  search string(s) or date matches will  be written to a
  112. NEW SWAG file.  Initially, this file is named GREPSWAG.SWG,  and will be in
  113. the current  directory. Upon completion of  this GREP process, you  will be
  114. asked for the  file name. Enter any name AND  directory you choose, and the
  115. file will be  RENAMED and moved to that directory.  This process allows you
  116. to  create  SWAG  files  containing  ANY  combination  of material that you
  117. please.
  118.  
  119. F5 toggles the STATS function. In order  for this to work, you MUST have at
  120. least ONE  .SWG file in  the directory box,  and it MUST  be highlighted !!
  121. Place  the cursor  any one  of the  .SWG files,  and press  F5. You will be
  122. presented with an  EXPANDED directory list showing the  description of each
  123. .SWG file and the number of snipets in each.
  124.  
  125. VIEWING, EXTRACTING, PRINTING SWAG SNIPETS
  126. ------------------------------------------
  127.  
  128. Once you have  some .SWG files in the directory  box, press <ENTER> and the
  129. package will be read and you be able to manage the SWAG snipets.
  130.  
  131. You will be  presented with a list of  all of the snipets contained  in the
  132. package with descriptions for each.
  133.  
  134. At the bottom of the screen, will be the following menu.
  135.  
  136. │                                                                          │
  137. │  F1-Help ▀     F3-Options ▀    ┘- Read  ▀    F4-Write ▀     ESC-Quit ▀  │
  138. │  ▄▄▄▄▄▄▄▄▄     ▄▄▄▄▄▄▄▄▄▄▄▄    ▄▄▄▄▄▄▄▄▄▄▄    ▄▄▄▄▄▄▄▄▄▄     ▄▄▄▄▄▄▄▄▄▄  │
  139.  
  140.  
  141.                 F1   - provides some "quick" ALT keys.
  142.  
  143.                 ┌──────────── READER : HELP ───────────┐
  144.                 │ Alt F       Find Text                │
  145.                 │ Alt S       Sort Index               │
  146.                 │ Alt T       Tag ALL                  │
  147.                 │ Alt U       UnTag ALL                │
  148.                 │ Spacebar    Tag Current              │
  149.                 │ <ENTER>     Read Item                │
  150.                 │                                      │
  151.                 │ F1          Help                     │
  152.                 │ F3          Program Options          │
  153.                 │ F4          Write Tagged Items       │
  154.                 │ ESC         Quit Program             │
  155.                 └──────────────────────────────────────┘
  156.  
  157.                 F3   - brings up the OPTIONS menu.
  158.  
  159.                 ┌──────────────────────┐
  160.                 │  About               │
  161.                 │  Sort - (ALT S)      │
  162.                 │  Spacebar Tag - ON   │
  163.                 │  Colors              │
  164.                 │  Screen Lines - 25   │
  165.                 └──────────────────────┘
  166.  
  167.                 <CR> - read the snipet
  168.                 F4   - Write TAGGED items
  169.                 ESC  - Quit
  170.  
  171.  
  172. 43/50 LINE VIDEO
  173. ----------------
  174.  
  175. You will have the capability of using 43/50 line screens if you have EGA or
  176. better.  The  option  can  be  found  in  the  OPTIONS  menu  (F3).  It  is
  177. automatically  disabled if  the user  doesn't have  the capability.  Select
  178. SCREENLINES, and if you have an EGA/VGA, you'll get 43/50 line mode.
  179.  
  180. COLORS
  181. ------
  182.  
  183. To be quite  honest, the whole business of allowing  users to change colors
  184. is quite a  problem. It adds a lot  of code to the program,  and more often
  185. than not, it is used only once  by the user. Therefore, the color selection
  186. if VERY limited.
  187.  
  188. There are  four color group  choices available. LIGHTGRAY,  BLUE, CYAN, and
  189. RED. Select one that you find pleasing. This will be disabled on monochrome
  190. monitors.
  191.  
  192. SORTING
  193. -------
  194.  
  195. ALT S brings up the SORT box. The snipets can be sorted by :
  196.  
  197.                         ┌────────────────────────────┐
  198.                         │                            │
  199.                         │  Select Sort Field :       │
  200.                         │                            │
  201.                         │         C - CONFERENCE     │
  202.                         │         N - NUMBER         │
  203.                         │         T - TO             │
  204.                         │         F - FROM           │
  205.                         │         S - SUBJECT        │
  206.                         │                            │
  207.                         └────────────────────────────┘
  208.  
  209.  
  210. TAGGING ITEMS
  211. -------------
  212.  
  213. Snipets can be tagged by using the SPACEBAR. SPACEBAR tag can be turned OFF
  214. in the OPTIONS menu.  ALL items can be tagged with ALT  T and untagged with
  215. ALT U. Tagged items can be written to a file with F4.
  216.  
  217. EXTRACTING SNIPETS
  218. ------------------
  219.  
  220. Snipets can be  extract to an ASCII file by  selecting and pressing the 'E'
  221. key. Enter  the filename, and  the data  with  be written out.  If the file
  222. selected is already on  your disk, you will be asked if  you want to APPEND
  223. or OVERWRITE.
  224.  
  225. WRITING TAGGED SNIPETS
  226. ----------------------
  227.  
  228. Once you  have tagged a  group of snipets,  you can write  them to an ASCII
  229. file using F4. Enter  the filename, and if it exists, you  will be asked if
  230. you want  to APPEND or OVERWRITE.  All of the tagged  items will be written
  231. sequentially.
  232.  
  233. FINDING TEXT IN SNIPETS
  234. -----------------------
  235.  
  236. You  can  use  the  (F)ind  command  to  find  text located within the SWAG
  237. snipets. This works JUST LIKE the BORLAND  PASCAL IDE. You can ALSO use the
  238. ^Q^F  key sequence  to activate  this function.  Just as  with the  IDE, ^L
  239. displays the NEXT find.
  240.  
  241. SWAG SNIPETS MARKED WITH CHECKMARK
  242. ----------------------------------
  243.  
  244. If you  see snipets with a  CHECKMARK (#251) beside them,  this indicates a
  245. NEW item  added since the LAST  update. The READER.EXE keeps  track of this
  246. and  marks  these  automatically.  The  checkmark  is  only  there for your
  247. reference.
  248.  
  249. We  hope that  you find  the READER   easy to  use, and  the SWAG  material
  250. valuable in development of your PASCAL programs.
  251.  
  252. ENJOY !!!!! and GOOD PROGRAMMING !!!
  253.  
  254. Gayle Davis AND Kerry Sokalsky
  255. SWAG Support Team
  256.